scale: Document the new CSS nodes
authorMatthias Clasen <mclasen@redhat.com>
Sat, 7 Nov 2015 00:38:50 +0000 (19:38 -0500)
committerMatthias Clasen <mclasen@redhat.com>
Sat, 7 Nov 2015 03:27:31 +0000 (22:27 -0500)
gtk/gtkscale.c

index 98c22c38eda125cf3d13ffeb16472b3ebee36c76..4b73c528ce6fc0ab64d775be90b71aff9ec7b26a 100644 (file)
  * # CSS nodes
  *
  * |[<!-- language="plain" -->
- * scale
+ * scale[.fine-tune]
  * ├── marks.top
  * │   ├── mark
  * │   ├── mark
  * │   ╰── ...
  * ├── trough
- * │   ╰── slider
+ * │   ├──slider
+ * │   ├── [highlight]
+ * │   ╰── [fill]
  * ╰── marks.bottom
  *     ├── mark
  *     ├── mark
  * The main node gets the style class .fine-tune added when the scale is in
  * 'fine-tuning' mode.
  *
+ * If the scale has an origin (see gtk_scale_set_has_origin()), there is a
+ * subnode with name highlight below the trough node that is used for rendering
+ * the highlighted part of the trough.
+ *
+ * If the scale is showing a fill level (see gtk_range_set_show_fill_level()),
+ * there is a subnode with name fill below the trough node that is used for
+ * rendering the filled in part of the trough.
+ *
  * If marks are present, there is a marks subnode before or after the trough
  * node, below which each mark gets a node with name mark. The marks nodes get
  * either the .top or .bottom style class.